home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Applications 1996 May / SGI IRIX 6.2 Applications 1996 May.iso / dist / impr_dev.idb / usr / impressario / bin / examples / libstiff / README.z / README
Text File  |  1996-05-06  |  2KB  |  59 lines
  1.  
  2.  
  3.                 Example Programs
  4.                      for
  5.                    libstiff
  6.  
  7.  
  8. These example programs demonstrate the use of the libstiff API. Each
  9. program is designed to demonstrate a particular aspect of the API.
  10. The programs also perform error handling using the library's error
  11. handling facilities. Refer to the libstiff(3) man pages for detailed
  12. information on the libstiff API.
  13.  
  14.  
  15. sinfo - Usage: sinfo [STIFF file]
  16.  
  17.     VERY USEFUL PROGRAM! Prints detailed information about a STIFF
  18.     format file. The header and IFD information is printed. For each
  19.     IFD the tags are printed. Offsets for IFD's and data are also
  20.     displayed. If a file is not specified on the command-line, stdin
  21.     is read. This is a very useful program for debugging a STIFF file
  22.     and for scanning the contents of a random STIFF file.
  23.  
  24.     Note that this program uses the fields in the STStream structure
  25.     to follow the IFD pointers in order to extract information from
  26.     the tags in each IFD. This is considered an advanced technique
  27.     and would not normally be required when reading or writing STIFF
  28.     files in a conventional manner.
  29.  
  30.  
  31. writeone - Usage: writeone
  32.  
  33.     A demo program that reads an X format bitmap image and writes it
  34.     to a STIFF format file. This program demonstrates the use of the
  35.     libstiff functions that write STIFF files intended for printing.
  36.     These are the so called Print STIFF (PST) functions. These
  37.     functions write a STIFF format file with additional tags that may
  38.     be of use to printer drivers and filter programs. The resulting
  39.     STIFF image is written to stdout and can be sent to a file using
  40.     redirection.
  41.  
  42.  
  43. band - Usage: band [STIFF file] [Output file]
  44.  
  45.     Prints detailed information about the input STIFF file as in sinfo.
  46.     It also converts the STIFF file to 'banded' format. A 'band' format
  47.     file contains one row of each color. If there are three samples (colors)
  48.     per pixel ( eg. RGB ), then a single input pixel row is divided into 
  49.     three smaller rows of the three colors.
  50.      For example,
  51.         RGBRGBRGB ...
  52.             becomes
  53.         RRR ...
  54.         GGG ...
  55.         BBB ...
  56.     Since this file format is not supported by STIFF currently, no header
  57.     information is attached with the data.
  58.  
  59.